Skip to content

feat(memtrack): collect RSS via rss_stat and folio-rmap reconstruction#453

Open
not-matthias wants to merge 15 commits into
mainfrom
cod-3089-collect-rss-in-memtrack
Open

feat(memtrack): collect RSS via rss_stat and folio-rmap reconstruction#453
not-matthias wants to merge 15 commits into
mainfrom
cod-3089-collect-rss-in-memtrack

Conversation

@not-matthias

@not-matthias not-matthias commented Jul 13, 2026

Copy link
Copy Markdown
Member

Summary

Adds RSS (resident set size) collection to memtrack, in two layers:

  1. Authoritative RSS from the kernel's kmem:rss_stat tracepoint — absolute per-mm resident bytes (anon/file/shmem/swap), latest-wins.
  2. Reconstructed anonymous RSS from raw kernel folio-rmap events: fentry hooks on the anon folio-rmap add/remove functions emit signed page-count deltas, so anon RSS can be rebuilt over time as Σ(add − remove) × PAGE_SIZE.

The reconstruction is a total anon RSS delta-sum, not a per-vaddr resident map — the kernel remove hook (folio_remove_rmap_ptes) carries no address, so removals can't be attributed to a vaddr (the add hooks' faulting vaddr is emitted for observability only).

Commits

  • feat(memtrack): track RSS via kmem:rss_stat tracepoint — the baseline: EVENT_TYPE_RSS contract, MemtrackEventKind::Rss, parser arm, writer bench case, gated integration test.
  • feat(memtrack): reconstruct anon RSS from gated folio rmap fentry hooksEVENT_TYPE_RMAP_ANON + RmapAnon event, five fentry programs (add_new / add_ptes / remove_ptes / remove_pmd / remove_pud), CO-RE folio helpers, and the load/attach gating.
  • test(memtrack): validate anon RSS reconstruction against rss_stat — ramps anon RSS via mmap/munmap and asserts the reconstructed estimate tracks the rss_stat MM_ANONPAGES peak within 25%.

What's on by default vs gated

  • rss_stat tracepoint: always on. Emitting Rss events is the intended new default behavior introduced by this change — the RSS tracepoint is not gated.
  • RmapAnon folio-rmap fentry programs: off by default, gated behind CODSPEED_MEMTRACK_TRACK_RMAP=1. When the flag is unset they are set_autoload(false) before load and never attached, so:
    • the skeleton still loads on any kernel (a missing fentry BTF target would otherwise fail the whole load), and
    • the folio-rmap reconstruction path stays out of production (--mode memory) and out of the existing test suites — no RmapAnon events are produced by default.

Verification

Run in a privileged, --pid=host container sharing the host kernel (7.0.12):

  • Reconstruction (flag on):real anon amplitude = 64 MiB, estimated peak = 64 MiB (ratio 1.00).
  • Regression (rss_tests, flag unset): ✅ passes — no RmapAnon events, folio-rmap programs stay unloaded.
  • Parser unit tests, cargo fmt, and clippy clean.
  • Kernel BTF signatures for all five folio_*_rmap* functions verified to match the BPF_PROG arg layouts.

Review notes (draft)

  • track_command ordering: the shared test helper spawns the child before enable()/track(root_pid). In practice the child's fork→execve→ld.so→libc-init far outlasts the two BPF-map updates, so tracking is armed before the workload allocates (both fixtures captured full event streams). Flagging in case we'd prefer a leading settle-usleep in the fixtures or an enable-before-spawn change in the helper.
  • PAGE_SIZE: hardcoded to 4096 (correct on x86_64). On a 16K/64K-page arm64 runner the estimate would need sysconf(_SC_PAGESIZE); rss_stat is already in bytes and unaffected. Happy to switch to sysconf if these tests run on arm64 CI.
  • The chart/inspection tooling used during development lives outside the tree (dev artifact) and is not part of this PR.

@codspeed-hq

codspeed-hq Bot commented Jul 13, 2026

Copy link
Copy Markdown

Merging this PR will not alter performance

⚠️ Unknown Walltime execution environment detected

Using the Walltime instrument on standard Hosted Runners will lead to inconsistent data.

For the most accurate results, we recommend using CodSpeed Macro Runners: bare-metal machines fine-tuned for performance measurement consistency.

✅ 17 untouched benchmarks


Comparing cod-3089-collect-rss-in-memtrack (fad337a) with main (26fb4b5)

Open in CodSpeed

@greptile-apps

greptile-apps Bot commented Jul 13, 2026

Copy link
Copy Markdown

Greptile Summary

This PR adds RSS collection and rmap-based RSS reconstruction to memtrack. The main changes are:

  • RSS events from the kmem:rss_stat tracepoint.
  • Optional folio rmap fentry hooks for reconstructed RSS totals.
  • New event parsing, writer support, and RSS test fixtures.
  • CI coverage for the new RSS tests across more runners.

Confidence Score: 5/5

This looks safe to merge.

  • No blocking issues found in the changed code.
  • The rmap tests now use an explicit constructor path instead of mutating process-wide environment state.
  • The latest changes did not add a new production failure that needs a separate fix.

Important Files Changed

Filename Overview
crates/memtrack/src/ebpf/c/rss.bpf.h Adds RSS tracepoint handling, rmap event emission, and process lifecycle events.
crates/memtrack/src/ebpf/memtrack/mod.rs Adds explicit rmap setup, page-size configuration, and BTF-based disabling for missing fentry targets.
crates/memtrack/src/ebpf/memtrack/tracking.rs Adds RSS tracepoint attachment and optional rmap fentry attachment.
crates/memtrack/tests/shared.rs Adds C fixture compilation and explicit helpers for rmap-enabled tracking.
crates/memtrack/tests/rss_tests.rs Adds integration coverage for RSS snapshots and rmap reconstruction behavior.

Reviews (16): Last reviewed commit: "ci: slim bpf-tests kernel diagnostic to ..." | Re-trigger Greptile

Comment thread crates/memtrack/tests/rss_reconstruction_tests.rs Outdated
Comment thread crates/memtrack/tests/rss_reconstruction_tests.rs Outdated
Comment thread crates/memtrack/src/ebpf/memtrack.rs Outdated
Comment thread crates/memtrack/tests/rss_reconstruction_tests.rs Outdated
Comment thread crates/memtrack/tests/shared.rs Outdated
@not-matthias
not-matthias force-pushed the cod-3089-collect-rss-in-memtrack branch 2 times, most recently from b670b0a to 2f41984 Compare July 13, 2026 17:32
@not-matthias
not-matthias marked this pull request as ready for review July 14, 2026 15:38
Comment thread crates/memtrack/src/ebpf/memtrack.rs Outdated
@not-matthias
not-matthias force-pushed the cod-3089-collect-rss-in-memtrack branch from 41945a5 to 64688a9 Compare July 17, 2026 14:23
Comment thread crates/memtrack/src/ebpf/memtrack.rs Outdated
@not-matthias
not-matthias force-pushed the cod-3089-collect-rss-in-memtrack branch 2 times, most recently from b02f3cb to 411b713 Compare July 17, 2026 18:12
@not-matthias
not-matthias changed the base branch from main to cod-1801-only-attach-to-used-libraries-in-memtrack July 20, 2026 09:07
@not-matthias
not-matthias force-pushed the cod-1801-only-attach-to-used-libraries-in-memtrack branch from 4d3fbb0 to a7e1666 Compare July 20, 2026 10:11
Base automatically changed from cod-1801-only-attach-to-used-libraries-in-memtrack to main July 20, 2026 13:12
Sample the kernel's per-mm resident counter through the kmem:rss_stat tracepoint, emitting absolute byte values per mm member. Adds the EVENT_TYPE_RSS contract, MemtrackEventKind::Rss, the parser arm, and a writer bench case.

An rss_stat update from reclaim or another process's madvise fires in the actor's context; track (mm_id, member) -> owning pid so those updates reach the owner. External events may only lower a counter, so stale reads and mm_id collisions cannot invent peaks.
Attach fentry hooks on the folio-rmap add/remove functions, emitting
signed page-count deltas per MM_* bucket so anon, file, and shmem RSS
can be reconstructed over time. Gated behind
CODSPEED_MEMTRACK_TRACK_RMAP; the programs stay autoload-off by default
so the skeleton loads on any kernel. Adds the EVENT_TYPE_RMAP contract,
MemtrackEventKind::Rmap, parser arm, and bench case.
A forked child's inherited RSS is invisible to rss_stat: the fork-time
counter copies fire outside the child's context, and anon COW faults
are counter-neutral, so a child that only touches inherited memory
never reports anything on its own. A fork event carrying the parent
pid lets consumers seed the child from the parent's last absolutes;
exec and exit mark where the address space is replaced or torn down.
Nine fixtures compare three per-process views - the fixture's own /proc report, rss_stat peaks, and rmap-reconstructed totals - plus an external-reclaim fixture proving out-of-context decrements reach the owner. Fork-seeded children are validated via fork_idle, whose 32 MiB is observable only through the fork-event seed. Pids are redacted and rows keep first-activity order so snapshots are stable across runs; fixtures report VmHWM instead of ru_maxrss, which survives execve and would leak the harness's peak RSS.
@not-matthias
not-matthias force-pushed the cod-3089-collect-rss-in-memtrack branch from 411b713 to 3037b25 Compare July 20, 2026 16:07
@not-matthias
not-matthias force-pushed the cod-3089-collect-rss-in-memtrack branch from e00fb6b to a68424a Compare July 20, 2026 16:08
Comment on lines +54 to +56
self.attach_task_newtask()?;
self.attach_sched_process_exec()?;
self.attach_sched_process_exit()?;

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Lifecycle Attaches Still Abort

These RSS lifecycle tracepoints still return errors from attach_tracepoints(), while rss_stat itself only warns and continues. If a host can attach the existing allocator probes but cannot attach task:task_newtask, sched:sched_process_exec, or sched:sched_process_exit, tracker startup still fails before allocator tracking begins. These tracepoints only support RSS fork/exec/exit reconciliation, so unsupported RSS lifecycle accounting can still make memory tracking unavailable.

Prompt To Fix With AI
This is a comment left during a code review.
Path: crates/memtrack/src/ebpf/memtrack/tracking.rs
Line: 54-56

Comment:
**Lifecycle Attaches Still Abort**

These RSS lifecycle tracepoints still return errors from `attach_tracepoints()`, while `rss_stat` itself only warns and continues. If a host can attach the existing allocator probes but cannot attach `task:task_newtask`, `sched:sched_process_exec`, or `sched:sched_process_exit`, tracker startup still fails before allocator tracking begins. These tracepoints only support RSS fork/exec/exit reconciliation, so unsupported RSS lifecycle accounting can still make memory tracking unavailable.

How can I resolve this? If you propose a fix, please make it concise.

Fix in Claude Code Fix in Codex

Comment on lines 53 to +55
self.attach_sched_fork()?;
self.attach_task_newtask()?;
self.attach_sched_process_exec()?;

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Lifecycle attaches abort

These RSS lifecycle tracepoints still propagate attach errors from attach_tracepoints(). Tracker::new() calls that method during normal memory tracking startup, so a host that can run the existing allocator probes but cannot attach task:task_newtask, sched:sched_process_exec, or sched:sched_process_exit will still fail before allocator tracking starts. Since these tracepoints only support RSS reconciliation, their attach failures should not make the whole tracker unavailable.

Prompt To Fix With AI
This is a comment left during a code review.
Path: crates/memtrack/src/ebpf/memtrack/tracking.rs
Line: 53-55

Comment:
**Lifecycle attaches abort**

These RSS lifecycle tracepoints still propagate attach errors from `attach_tracepoints()`. `Tracker::new()` calls that method during normal memory tracking startup, so a host that can run the existing allocator probes but cannot attach `task:task_newtask`, `sched:sched_process_exec`, or `sched:sched_process_exit` will still fail before allocator tracking starts. Since these tracepoints only support RSS reconciliation, their attach failures should not make the whole tracker unavailable.

How can I resolve this? If you propose a fix, please make it concise.

Fix in Claude Code Fix in Codex

@not-matthias
not-matthias force-pushed the cod-3089-collect-rss-in-memtrack branch from e48a0a0 to f305358 Compare July 20, 2026 16:28
Comment on lines +54 to +56
self.attach_task_newtask()?;
self.attach_sched_process_exec()?;
self.attach_sched_process_exit()?;

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Lifecycle Attaches Still Abort

These RSS lifecycle tracepoints still return attach errors from attach_tracepoints(). Tracker::new() and new_without_allocators_with_rmap() both call this method during startup, so a host that can run the allocator probes but cannot attach task:task_newtask, sched:sched_process_exec, or sched:sched_process_exit will still fail before memory tracking starts. These events only support RSS reconciliation, so their attach failures should disable that RSS lifecycle path rather than make all memtrack modes unavailable.

Prompt To Fix With AI
This is a comment left during a code review.
Path: crates/memtrack/src/ebpf/memtrack/tracking.rs
Line: 54-56

Comment:
**Lifecycle Attaches Still Abort**

These RSS lifecycle tracepoints still return attach errors from `attach_tracepoints()`. `Tracker::new()` and `new_without_allocators_with_rmap()` both call this method during startup, so a host that can run the allocator probes but cannot attach `task:task_newtask`, `sched:sched_process_exec`, or `sched:sched_process_exit` will still fail before memory tracking starts. These events only support RSS reconciliation, so their attach failures should disable that RSS lifecycle path rather than make all memtrack modes unavailable.

How can I resolve this? If you propose a fix, please make it concise.

Fix in Claude Code Fix in Codex

@not-matthias

Copy link
Copy Markdown
Member Author

@greptileai pause reviews for now until i enable them again

@greptile-apps

greptile-apps Bot commented Jul 20, 2026

Copy link
Copy Markdown

Understood — pausing reviews. I'll hold off until you re-enable them.

Tip: You can customize Greptile's behavior for this repo with .greptile/rules.md and .greptile/config.json.

Comment on lines +54 to +56
self.attach_task_newtask()?;
self.attach_sched_process_exec()?;
self.attach_sched_process_exit()?;

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Lifecycle Attaches Still Abort

These RSS lifecycle tracepoints still return errors from attach_tracepoints(), while rss_stat itself only warns and continues. Tracker::new() and new_without_allocators_with_rmap() call this during startup, so a host that can run the allocator probes but cannot attach task:task_newtask, sched:sched_process_exec, or sched:sched_process_exit still fails before memory tracking starts. These tracepoints only support RSS lifecycle reconciliation, so their attach failures should disable that RSS lifecycle path instead of taking down all memtrack startup.

Prompt To Fix With AI
This is a comment left during a code review.
Path: crates/memtrack/src/ebpf/memtrack/tracking.rs
Line: 54-56

Comment:
**Lifecycle Attaches Still Abort**

These RSS lifecycle tracepoints still return errors from `attach_tracepoints()`, while `rss_stat` itself only warns and continues. `Tracker::new()` and `new_without_allocators_with_rmap()` call this during startup, so a host that can run the allocator probes but cannot attach `task:task_newtask`, `sched:sched_process_exec`, or `sched:sched_process_exit` still fails before memory tracking starts. These tracepoints only support RSS lifecycle reconciliation, so their attach failures should disable that RSS lifecycle path instead of taking down all memtrack startup.

How can I resolve this? If you propose a fix, please make it concise.

Fix in Claude Code Fix in Codex

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant